//
// Copyright (c) ZeroC, Inc. All rights reserved.
//

#ifndef ICE_SSL_RFC_2253_H
#define ICE_SSL_RFC_2253_H

#include "Ice/Config.h"

#include <list>
#include <string>

//
// The methods in the Ice::SSL::RFC2253 namespace implement a parser
// for relative distinguished name (RDN) pairs using the parsing
// rules outlined in sections 3 and 4 of RFC 2253.
//
// Note that this parser does not unescape the elements of the RDNs.
// For example, parsing the following RDN
//
// O=Sue\, Grabit and Runn
//
// results in the pair ("O","Sue\, Grabit and Runn") and not
// ("O","Sue, Grabit and Runn").
//
namespace Ice::SSL::RFC2253
{
    using RDNSeq = std::list<std::pair<std::string, std::string>>;

    struct ICE_API RDNEntry
    {
        RDNSeq rdn;
        bool negate;
    };
    using RDNEntrySeq = std::list<RDNEntry>;

    //
    // This function separates DNs with the ';' character. A list of RDN
    // pairs may optionally be prefixed with '!' to indicate a negation.
    // The function returns a list of RDNEntry structures. Any failure in
    // parsing results in a ParseException being thrown.
    //
    ICE_API RDNEntrySeq parse(const std::string&);

    //
    // RDNs are separated with ',' and ';'.
    //
    // This function returns a list of RDN pairs. Any failure in parsing
    // results in a ParseException being thrown.
    //
    ICE_API RDNSeq parseStrict(const std::string&);

    //
    // Unescape the string.
    //
    ICE_API std::string unescape(const std::string&);

}

#endif
